Prerequisiti
Prima di installare Apache Ant su Windows 10 assicurati che Java sia già installato
Scaricare Apache Ant
Rechiamoci alla pagina ufficiale per il download, al link https://ant.apache.org/bindownload.cgi
Se sulla nostra macchina è installata una versione Java che sia la 5, 6 o 7 dovremo scaricare il primo file .zip apache-ant-1.9.15-bin.zip evidenziato. Se è installata una versione Java che sia la 8 o superiore, dovremo scaricare il secondo file .zip apache-ant-1.10.9-bin.zip evidenziato.
Nel momento in cui questo articolo è stato scritto, le versioni Ant da scaricare (in base alle versioni Java elencate prima) sono rispettivamente la 1.9.15 e la 1.10.9
Installare Apache Ant su Windows 10
Consideriamo per esempio di aver scaricato il file binario apache-ant-1.10.9-bin.zip (la procedura che leggerete nel prosieguo dell’articolo, rimane identica per qualsiasi altra versione). Decomprimiamolo nella cartella C:\Program Files, assieme agli altri programmi di Windows.
Cliccando sulla cartella appena scompattata, troveremo al suo interno una struttura come la seguente
Questo è quanto, l’installazione di Apache Ant è completata, congratulazioni!
Come verifica, rechiamoci nella cartella \bin contenente l’eseguibile ant.cmd ed apriamo il prompt dei comandi per digitare la seguente istruzione ant:
C:\Program Files\apache-ant-1.10.9\bin>ant -version
Ops….cos’è successo? Ant è stato installato, infatti l’istruzione ant è stata riconosciuta, tuttavia ha portato all’errore mostrato. Come suggerito dal messaggio stesso, dobbiamo aggiungere e valorizzare corrattamente la variabile di ambiente ANT_HOME
Aggiungere la variabile di ambiente ANT_HOME
Anche se ora Ant è installato, per poterne utilizzare i comandi da riga di comando, sia a partire dalla cartella \bin vista al paragrafo precedente, sia a partire da qualsiasi altro punto del computer, dobbiamo aggiungere la relativa variabile di ambiente.
Digitiamo quindi “variabili di ambiente” dalla casella di ricerca della barra delle applicazioni
e clicchiamo su “Modifica le variabili di ambiente relative al sistema” .
Comparirà la finestra “Proprietà del sistema”
Dal tab “Avanzate” clicchiamo quindi sul bottone “Variabili d’ambiente…” in basso a destra per far comparire la finestra “Variabili d’ambiente”. A questo punto dobbiamo scegliere se
- creare una nuova variabile d’ambiente valida per tutti gli utenti del sistema.
- oppure crearne una valida solo per la nostra utenza
Optiamo per la seconda alternativa: clicchiamo quindi sul bottone “Nuova…” della sezione “Variabili dell’utente …” così da aprire la finestra “Nuova variabile utente”.
Per il Nome inseriamo ANT_HOME, mentre per Valore inseriamo il percorso dove abbiamo scompattato il file binario scaricato al paragrafo precedente (nel nostro esempio il path è C:\Program Files\apache-ant-1.10 )
Infine clicchiamo “Ok”. Assicuriamoci di fare lo stesso anche per le altre 2 finestre rimaste aperte.
Aggiungere %ANT_HOME%\bin a Path
La procedura mostrata al paragrafo precedente è solo un’azione preliminare, ma di per se non ci permette di utilizzare i comandi Ant ovunque noi vogliamo, ma solo a partire dalla cartella \bin all’interno della cartella di installazione che, ricordiamolo, per il nostro esempio è C:\Program Files\apache-ant-1.10.9
Se vogliamo usare i comandi Ant da qualsiasi punto del File System, dobbiamo aggiungere il percorso C:\Program Files\apache-ant-1.10.9\bin (contenente l’eseguibile ant) alla variabile Path di Windows.
Raggiungiamo quindi la finestra delle “Variabili d’ambiente” come fatto al paragrafo precedente.
Anche questa volta dobbiamo scegliere se
- Modificare la variabile d’ambiente Path per tutti gli utenti del sistema. In questo caso i comandi Maven saranno così accessibili per qualsiasi utente Windows.
- Modificare la variabile d’ambiente Path solo per la nostra utenza. In questo modo i comandi Maven saranno accessibili solo per l’utente Windows che stiamo usando.
Optiamo per la seconda alternativa, quindi procediamo seguendo i passi:
- Facciamo doppio Click sulla variabile Path della sezione “Variabili dell’utente …”
- Comparirà così la finestra “Modifica variabile di ambiente” da cui clicchiamo il bottone “Nuovo” in alto a destra
- Il cursore si sposterà in automatico in fondo alla lista: inseriamo la stringa %ANT_HOME%\bin
Infine clicchiamo “Ok”. Assicuriamoci di fare lo stesso anche per le altre 2 finestre rimaste aperte.
Se abbiamo compiuto correttamente tutti i passaggi dovremmo poter usare i comandi Ant a partire da una cartella qualsiasi.
Proviamo quindi a verificare nuovamente la versione di Apache Ant, stavolta a partire dalla cartella C:\ digitando
C:\>ant-version
Riferimenti
Ora che hai installato Apache Ant, se vuoi approfondire la conoscenza di questo tool, ti suggerisco di leggere il mio articolo Apache Ant Tutorial Base Per Principianti